************************* Use C-Pg Up to return *******************************
********************* Use Pg Up and Pg Dn to scroll ***************************
*************************** Use C-s to search *********************************
Copyright (C) 1993 Leon van Dommelen      There is no warranty on this software

				Mouse

This file covers editing tasks that can be done using the mouse.

Topics:
-------------------------------------------------------------------------------

Intro				General concepts

Left Down			Positioning, scrolling or selecting text
- Scrolling			Moving through the file
- Positioning			Position the cursor at the pointer
- Selecting			Selecting text
- Return			Acts as Return when answering prompts
- Yes				Acts as Y on yes-or-no queries
S-Left Down			Sets a mark
C-Left Down			Selects to the mark
M-Left Down			Kills the selected text

Right Down			Open the menu
- Menu				Open the menu
- Abort				Acts as abort when answering prompts
- No				Acts as N on yes-or-no queries
S-Right Down			Swap the positions of cursor and mark
C-Right Down			Copy from pointer to cursor
M-Right Down			Restore the text killed with M-Left Down

Middle Down			Same as C-Right Down


				= Intro =
-------------------------------------------------------------------------------

Some editing tasks can be done effectively using a standard two or three button
mouse.  It is quicker to find a point on the screen using a mouse pointer than
by means of arrow keys and such.

The position of the mouse is indicated by the mouse pointer, an inverse video
character position.  The pointer is in general at a different position than the
cursor.  Text is inserted or deleted at the cursor, not at the pointer.

To activate a mouse function, position the pointer at the right place and
press one of the mouse buttons.  The buttons are indicated as Left Down,
Middle Down, and Right Down.  You may need to hold the <Shift>, <Ctrl>, or
<Alt> key down while pressing the button; this is indicated by a prefix
S-, C-, or M-.


				= Left Down =
-------------------------------------------------------------------------------

The left button performs different tasks, depending on the circumstances:

Scrolling:
----------

Pressing and holding the left button in the top or bottom margins scrolls the
screen.  The margins cover 20% of the screen by default.  They can be set with
M-x set-some-options.  This also allows the scroll rate to be adjusted.

Positioning:
------------

Clicking and releasing the left button will position the cursor at the pointer.

Note: the pointer must be outside of the 20% top and bottom margins of the
screen, or the screen will scroll instead.

Selecting:
----------

The left button can be used to select text for killing, case changes, etcetera.
Double click and hold the left button on the second click to start selecting
all text the pointer passes.

Note: the pointer must be outside of the 20% top and bottom margins of the
screen, or the screen will scroll instead.

If you release the button after the second click without moving the pointer,
it selects the word the cursor is on, or if the pointer is on a parenthesis
or bracket, to the opening parenthesis or bracket, or if it is on a point,
exclamation mark, or question mark, it selects the sentence, or if it is on
end-of-line, it selects the line.

Return:
-------

If you are answering a prompt, such as specifying a file, the left button acts
as a Return key.  Can be quicker than hitting Return under certain conditions.

Yes:
----

If you are answering a Y/N? query, the left button replies Y.  This can be
quicker than pressing Y under certain conditions.

See key:	Left Down


				= S-Left Down =
-------------------------------------------------------------------------------

Pressing the left button while holding <Shift> sets a mark at the pointer.
This has the effect of selecting all text from the pointer to the cursor.

You can follow with such menu choices as `Cut marked' or `Marked uppercase'.
See topic:	Right Down, subtopic Menu

See key:	S-Left Down


				= C-Left Down =
-------------------------------------------------------------------------------

Pressing the left button while holding <Ctrl> puts the cursor at the pointer
and selects all text from pointer to mark.  The mark can be set first using
S-Left Down
See topic:	S-Left Down

The selected text can be killed using M-Left Down, or you can follow with such
menu choices as `Cut marked' or `Marked uppercase'.
See topic:	M-Left Down
See topic:	Right Down, subtopic Menu

See key:	C-Left Down


				= M-Left Down =
-------------------------------------------------------------------------------

Pressing the left button while holding <Alt>, or pressing <Esc> first,
kills the highlighted text.

To highlight text, first double click and hold the left button, or press
C-Left Down
See topic:	Left Down, subtopic Selecting
See topic:	C-Left Down

To restore the text again, immediately follow with a second M-Left Down.
To restore the killed text at another position, use M-Right Down.

See key:	M-Left Down


				= Right Down =
-------------------------------------------------------------------------------

The right button performs different tasks, depending on the circumstances:

Menu:
-----

If the right button is pressed and released, a menu of editing tasks is opened.
Click the left button with the pointer on the desired choice, or the right
button once more to abort.

See subject:	Intro, topic Menu	for more information on the menu.

Abort:
------

If you are answering a prompt, such as specifying a file, clicking the right
button acts as C-g:  it clears your input if not nil, and aborts the command
if it is nil.

On the query [B]ackup or [R]eplace, it aborts the file saving operation.

No:
---

If you are answering a Y/N? query, the right button replies N.  This can be
quicker than pressing N under certain conditions.

See key:	Right Down


				= S-Right Down =
-------------------------------------------------------------------------------

Pressing the right button while holding <Shift> interchanges the positions
of mark and cursor.  The mark can be set first usin S-Left Down.  The cursor
can be set using Left Down.
See topic:	S-Left Down
See topic:	Left Down, subtopic Positioning

See key:	S-Right Down


				= C-Right Down =
-------------------------------------------------------------------------------

Pressing the right button while holding <Ctrl> copies text left of the mouse
pointer to the cursor position.

How much text is copied depends on the position of the pointer:
if it is on an opening parenthesis or bracket, it copies everything to the
matching closing parenthesis or bracket.  If it is on `, it copies to '.
Else, if it is at the start of the line, it copies the line, else it copies
the next word.

See key:	C-Right Down


				= M-Right Down =
-------------------------------------------------------------------------------

Pressing the right button while holding <Alt>, or after pressing <Esc>,
restores the last killed text at the position of the cursor.

Text can be killed first using M-Left Down.
See topic:	M-Left Down

To avoid ambiguity, the pointer must be at the cursor before you use
M-Right Down.  You can put the cursor at the pointer by first clicking the
left button.
See topic:	Left Down, subtopic Positioning

To restore earlier kills, keep clicking M-Right Down.

To kill the restored text again, click M-Left Down.
See topic:	M-Left Down

See key:	M-Right Down


				= Middle Down =
-------------------------------------------------------------------------------

Pressing the middle mouse button is the same as pressing the right button
while holding <Ctrl>.
See topic:	C-Right Down

You must have a three button mouse in three button mode.

See key:	Middle Down


************************* Use C-Pg Up to return  ******************************
************************* Use Pg Up to scroll up ******************************
*******************************************************************************
